home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / conv / sfwjpg.readme < prev    next >
Text File  |  1999-03-02  |  8KB  |  189 lines
  1. Short:    Seattle FilmWorks (SFW) to JFIF converter (68k+PPC)
  2. Author:   Everett Lipman, Andreas R. Kleinert (port/adjustments)
  3. Uploader: Andreas_Kleinert@t-online.de
  4. Type:     gfx/conv
  5.  
  6.  This is an Amiga (68k+PPC) port (*) of Everett Lipman's
  7.  GNU tools sfwjpg, pwpjpg and flipjpeg plus
  8.  the shell script pwpext for conversion of
  9.  SFW JPEG files to normal JFIF files (SWF
  10.  seems to be a somewhat strange non-standard
  11.  JPEG derivate, which isn't very well documented)
  12.  
  13.  Enjoy the Amiga port. See directory "orig" for
  14.  the complete, original archive as taken from
  15.  Everett's homepage under http://isi9.mtwilson.edu/~lipman/
  16.  (I've just converted it from .tar to .lha for
  17.  convenience.)
  18.  
  19.  I've also added a copy of the GNU license, which
  20.  was missing (COPYING) - you may as well obtain it
  21.  from the GPL site under http://www.fsf.org/copyleft/gpl.html
  22.  
  23.  This software is based in part on the work of the Independent
  24.  JPEG Group. Not included is the source of libjpeg - so, for
  25.  recompilation you will have to obtain and compile a copy
  26.  yourself, first.
  27.  
  28.  PPC binaries have the ".elf" extension and are useable from Shell
  29.  when being used with ppc.library V46+
  30.  
  31.  Following is an excerpt from the original docs.
  32.  
  33.  Have fun.
  34.  
  35.  --                           (*) added smakefile, SCOPTIONS
  36.  ARK, 11/Jan/99                   and an additional header;
  37.                                   for source changes, see
  38.                                   amiga.h and pwpjpg.c
  39.  
  40.  *************************************************************************************
  41.  *************************************************************************************
  42.  
  43.   The programs sfwjpg and pwpjpg convert from Seattle
  44.   FilmWorks's private file formats to JFIF (JPEG File Interchange
  45.   Format).  As far as I am aware, Seattle FilmWorks does not
  46.   make public the specifications of these formats.  The format
  47.   specifications were deduced by examining a number of
  48.   .sfw and .pwp files, and may not be entirely accurate.  In
  49.   particular, some .sfw files which were downloaded from the SFW
  50.   web site were not properly converted to JFIF.  All .pwp files
  51.   which were downloaded from SFW and tried have been converted
  52.   without any problems.
  53.  
  54.   pwpext is a UNIX (Bourne) shell script, and will not work
  55.   unless pwpjpg and flipjpeg are in the search path ($PATH)
  56.   when it is invoked.
  57.  
  58.   flipjpeg is written using the Independent JPEG Group's free
  59.   JPEG software.  It has only been tested under UNIX.  Because
  60.   of some attributes of the JPEG compression scheme, flipjpeg
  61.   will only work on images whose height in pixels is a multiple
  62.   of 8, and sometimes only on those whose height is a multiple
  63.   of 16.  Since SFW scans at 640x480, flipjpeg will work for
  64.   converted SFW images.  See details.txt for more info.
  65.  
  66.  
  67. sfwjpg
  68.  
  69.   sfwjpg will take a single .sfw file and convert it into a
  70.   .jpg (JFIF) file.  The image in the newly created .jpg file
  71.   will then need to be flipped vertically.  sfwjpg takes a
  72.   single argument, the name of the .sfw file to be converted:
  73.  
  74.   sfwjpg mypic.sfw
  75.  
  76.   This will create the file mypic.jpg in the current directory.
  77.   mypic.sfw will not be altered or removed.  Under Microsoft
  78.   Windows, sfwjpg.exe must be invoked from the run window
  79.   command line.
  80.  
  81.  
  82. pwpjpg
  83.  
  84.   pwpjpg will take a .pwp file and extract the images in the
  85.   file.  A .pwp file typically contains the scanned images from
  86.   an entire roll of film.  The names of the images are contained
  87.   within the .pwp file.  pwpjpg takes a single argument, the
  88.   name of the .pwp file from which to extract the images:
  89.  
  90.   pwpjpg mypics.pwp
  91.  
  92.   This will extract all of the images contained in mypics.pwp
  93.   and write them in the current directory as .jpg (JFIF) files.
  94.   The file names will correspond to the names of the images
  95.   stored in the .pwp file.  mypics.pwp will not be altered or
  96.   removed.  Under Microsoft Windows, pwpjpg.exe must be invoked
  97.   from the run window command line.
  98.  
  99.  
  100. flipjpeg
  101.  
  102.   flipjpeg will do a lossless vertical inversion of the image in
  103.   a .jpg file.  This is a complicated process which is described
  104.   in details.txt.  flipjpeg was written to run under UNIX, and
  105.   uses standard input and output:
  106.  
  107.   flipjpeg < mypic.jpg > myflippedpic.jpg
  108.  
  109.   This will create the file myflippedpic.jpg, which will contain
  110.   the same image as mypic.jpg, except that the vertical ordering
  111.   of the scan lines will be reversed in myflippedpic.jpg.  This
  112.   flipping can be done by most image processing programs, though
  113.   usually not without some gain in file size and/or loss in
  114.   image quality.
  115.  
  116.  
  117. pwpext
  118.  
  119.   pwpext is a UNIX (Bourne) shell script which extracts and
  120.   flips the images from a .pwp file.  It takes a single
  121.   argument, the name of the .pwp file:
  122.  
  123.   pwpext mypics.pwp
  124.  
  125.   This will extract, flip, and store as .jpg files all of the
  126.   images contained in mypics.pwp.  mypics.pwp will not be
  127.   altered or removed.
  128.  
  129.  *************************************************************************************
  130.  *************************************************************************************
  131.  
  132.  Note:
  133.  
  134.   Due to previous events, this note seems to be necessary.
  135.  
  136.   While I've nothing against ports to other kernels, in my opinion it would
  137.   be quite unfair to remove all references to my own efforts and contributions
  138.   and simply replacing those with others, while also removing all references
  139.   to PPC-Lib/ELF and replacing those with other references and maybe some flames
  140.   or even offenses against the competing kernel and porter - without actually
  141.   rewriting the readme text itself in a major way (for example, if I describe what
  142.   *I* specifically did for the port - and what someone else wouldn't have to do a
  143.   *second* time, of course - and if then that one does not even remove/change *those*
  144.   notes and/or give me credit).
  145.  
  146.   You know - since even developing free software costs some money (especially
  147.   phonecosts), at least give some fame and credits back... ;-)
  148.  
  149.   This leads to the strange situation, that I hereby have to copyright this
  150.   .readme text, to claim its authorship and forbid changes which aren't
  151.   clearly marked as being changes to the original: While quotes may have
  152.   been derived from other parts of the distribution, the whole .readme as
  153.   such now is (C)opyrighted by Andreas R. Kleinert in 1998.
  154.  
  155.   Copyrights to the other files remain as such. Nevertheless I'd ask anyone
  156.   to give me credit for the changes which I did myself and which of
  157.   course have been labeled/marked/documented as such. Even free software
  158.   lives from respecting the intellectual work and property of others. Thank you.
  159.  
  160.  *************************************************************************************
  161.  *************************************************************************************
  162.  
  163.  
  164. ============================= Archive contents =============================
  165.  
  166. Original  Packed Ratio    Date     Time    Name
  167. -------- ------- ----- --------- --------  -------------
  168.     1932     953 50.6% 10-Jul-98 20:25:54 +pwpext
  169.       46      46  0.0% 10-Jul-98 20:28:20 +README
  170.    17982    6993 61.1% 10-Jul-98 20:54:34 +COPYING
  171.     8984    3720 58.5% 10-Jul-98 20:25:54 +details.txt
  172.     4157    1779 57.2% 10-Jul-98 20:25:54 +usage.txt
  173.    53562   53562  0.0% 10-Jul-98 20:26:32 +sfwjpg-unix.lha
  174.     6771    2738 59.5% 11-Jan-99 21:34:12 +sfwjpg.readme
  175.      122      96 21.3% 10-Jul-98 20:43:08 +amiga.h
  176.     7231    2452 66.0% 10-Jul-98 20:42:08 +flipjpeg.c
  177.      343     234 31.7% 04-Oct-98 09:51:20 +scoptions
  178.    10017    3012 69.9% 10-Jul-98 20:25:54 +sfwjpg.c
  179.     1420     410 71.1% 04-Oct-98 09:57:30 +smakefile
  180.    56020   32238 42.4% 11-Jan-99 21:45:48 +flipjpeg
  181.   108694   52241 51.9% 11-Jan-99 21:45:50 +flipjpeg.elf
  182.    14920    9426 36.8% 11-Jan-99 21:45:48 +pwpjpg
  183.    49045   21839 55.4% 11-Jan-99 21:45:50 +pwpjpg.elf
  184.    14512    9219 36.4% 11-Jan-99 21:45:48 +sfwjpg
  185.    47930   21424 55.3% 11-Jan-99 21:45:50 +sfwjpg.elf
  186.    11577    3338 71.1% 11-Jan-99 21:44:14 +pwpjpg.c
  187. -------- ------- ----- --------- --------
  188.   415265  225720 45.6% 14-Jan-99 06:07:38   19 files
  189.